home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / pco323.arc / README.2 < prev    next >
Text File  |  1986-12-15  |  8KB  |  210 lines

  1. These 9 utility programs are included for your convenience.  Except for 
  2. MTCONV.EXE, they are not connected in any way with PC-OUTLINE.  They were 
  3. written by the developers of PC-OUTLINE for their own convenience and are 
  4. shared with you in hopes that they will likewise make your life a little 
  5. easier.  Who said you never get SOMETHING for NOTHING? 
  6.  
  7.  
  8.                        9 UTILITY PROGRAMS
  9.                        ==================
  10.  
  11.  
  12. 1)  GLOBAL.COM - for doing any dos function on an entire directory
  13.                  tree at once.  Useful for finding lost files or deleting
  14.                  all .BAK files, etc. across many directory boundaries.
  15.  
  16. 2)  CPY.COM    - for backing up a series of files to floppy.  You can list
  17.                  the files to be backed up in a separate file and CPY will
  18.                  automatically prompt you on when to insert a new disk.
  19.  
  20. 3)  DIRS.COM   - gives the total disk space occupied by a set of files.
  21.                  Useful for seeing how much disk space a bunch of files
  22.                  are taking up.  For example, "DIRS *.wks" would tell you
  23.                  how much space all of your .wks files in the current
  24.                  directory occupy.
  25.  
  26. 4)  MOVE.COM   - Allows you to actually move a file from one directory to
  27.                  another without an intermediate copy.
  28.  
  29. 5)  MEM.COM    - Shows the amount of free memory without waiting for a time
  30.                  consuming CHKDSK.
  31.  
  32. 6)  BEEP.COM   - Generates a beep.  Useful for batch files to indicate errors
  33.                  or completion.
  34.  
  35. 7)  PUSHDIR.COM- Saves the current directory from a batch file.
  36.  
  37. 8)  POPDIR.COM - Restores the current directory from the previous
  38.                  PUSHDIR.
  39.  
  40. 9)  MTCONV.EXE - Converts a Maxthink outline into Structured File Format, which 
  41.                  may then be loaded into PC-Outline.
  42.  
  43. ===============================================================================
  44. ===============================================================================
  45.  
  46.                        DETAILED DESCRIPTIONS:
  47.  
  48. GLOBAL.COM
  49. ----------
  50.  
  51. USAGE:    GLOBAL <any dos command or executable program>
  52.  
  53. Global executes any dos command or program on an entire directory tree.
  54.  
  55. For example, if you log to the root directory and execute "GLOBAL DIR" then
  56. you will see a directory listing of every directory and sub-directory on
  57. your hard disk.
  58.  
  59. If you execute "GLOBAL DIR PLAY.DOC", then you will find all occurences of
  60. PLAY.DOC on your hard disk.
  61.  
  62. You can even use non-dos commands like "GLOBAL DIRS *.WKS" would show you the
  63. total disk space occupied by all .wks files in each directory on your hard
  64. disk.
  65.  
  66. Global.com starts from the current directory and goes down the directory tree.
  67. To cover the whole disk, start in the root directory.  To just cover part of the
  68. hard disk, start in a sub-directory.
  69.  
  70. ===============================================================================
  71.  
  72. CPY.COM
  73. -------
  74.  
  75. USAGE #1:    CPY <same dos parameters as the COPY command> OR
  76. USAGE #2     CPY @<filename> destination path
  77.  
  78. USAGE #1:
  79.  
  80. CPY can be a direct replacement for the copy command in dos with the added
  81. benefit that it will not quit when a floppy fills up.  Instead it will,
  82. stop, erase the partial file, prompt you for a new floppy and continue on
  83. its way.
  84.  
  85. For example:  "CPY c:\*.wks a:" would copy all .wks files in the root
  86. directory of c: to a:.  If the floppy in drive a: filled up during the copy,
  87. the partially copied file would be erased from the destination floppy and
  88. you would be prompted for a new floppy.
  89.  
  90. USAGE #2:
  91.  
  92. This usage of the CPY commmand allows you to specify a series of filenames
  93. to be copied to the same location.  Simply create an ascii file (let's use
  94. a file named CPYFILES for the sake of this example) with each file to be copied
  95. listed, one per line (wildcards are allowed).  Then to copy all of those files
  96. to a new location simply type "CPY CPYFILES A:" and one by one all the files
  97. listed in the CPYFILES will be copied to a:.  Again, if the floppy fills up
  98. you will be prompted to insert a new one.
  99.  
  100. The can be extremely useful for backing up to floppy a standard set of files
  101. that doesn't easily conform to a simple dos wildcard.
  102.  
  103. ===============================================================================
  104.  
  105. DIRS.COM
  106. --------
  107.  
  108. USAGE:    DIRS <any dos path/filename>       (wildcards permitted)
  109.  
  110. DIRS works just like DIR except instead of displaying each of the files, it
  111. simply adds the sizes of all of the files that would have been displayed
  112. had it been the DIR command.  DIRS uses the space actually occupied on the
  113. disk, not just the listed file size in the DIR listing.  NOTE:  hard disk
  114. space is allocated in 4k increments on the XT so that a file that shows up
  115. as 7 bytes like BEEP.COM actually takes up 4k on the hard disk.  DIRS takes
  116. this into account.
  117.  
  118. For example "DIRS *.WKS" would show you how much space all your .wks files were
  119. occupying.  Or  "DIRS *.BAK" would show you how much space would be freed if
  120. you erased all the .BAK files.
  121.  
  122. ===============================================================================
  123.  
  124. MOVE.COM
  125. --------
  126.  
  127. USAGE:     MOVE <source path/filename> <destination path/filename>
  128.  
  129. MOVE will move a file from one directory to another without making an
  130. intermediate copy.  The two names must be on the same disk drive.
  131.  
  132. For example, "MOVE C:\PLAY\TEMP C:\TEST" will move the file c:\play\temp to
  133. a new location and name c:\test.
  134.  
  135. ===============================================================================
  136.  
  137. MEM.COM
  138. -------
  139.  
  140. USAGE:    MEM
  141.  
  142. MEM lists the amount of free memory in your computer as reported by dos
  143. without having to wait for the painstakingly slow CHKDSK command.
  144.  
  145. ===============================================================================
  146.  
  147. BEEP.COM
  148. --------
  149.  
  150. USAGE:    BEEP
  151.  
  152. BEEP makes a beeping noise on the speaker.  This can be very useful in batch
  153. files to indicate either an error condition or completion of some long task.
  154.  
  155. ===============================================================================
  156.  
  157. PUSHDIR.COM
  158. -----------
  159.  
  160. USAGE:    PUSHDIR <optional pathname>
  161.  
  162. PUSHDIR allows you to save the current directory from a batch file, switch to
  163. another current directory and switch back to the original later in the batch
  164. file (by using its companion POPDIR).  For example, if 123 was located in a
  165. directory called c:\123, then you could create a batch file like the following:
  166.  
  167. PUSHDIR C:\123
  168. 123
  169. POPDIR
  170.  
  171. Assuming you had pathed to the batch file, you could then start 123 from
  172. anywhere on you hard disk and when you left 123, your current directory would
  173. automatically be restored as if you never left it.  Note that this is different
  174. than just pathing to 123 because 123 (like many other programs) needs the
  175. current directory to be set properly so that it can find its support files
  176. (configuration files and drivers).
  177.  
  178. The first time you use PUSHDIR a small piece of it will remain resident (about
  179. 400 bytes).  This is the storage area used to save the current directory.
  180. Subsequent PUSHDIR's and POPDIR's do not use any more memory.
  181.  
  182. PUSHDIR's and POPDIR's can be nested up to 6 levels deep.  Each PUSHDIR will
  183. save the latest current directory and each POPDIR will restore the last one
  184. saved.
  185.  
  186. ===============================================================================
  187.  
  188. POPDIR.COM
  189. ----------
  190.  
  191. USAGE:    POPDIR
  192.  
  193. POPDIR is just the counterpart to PUSHDIR.  After a PUSHDIR, POPDIR will
  194. restore the previous current directory.  See the documentation on PUSHDIR for
  195. more information.  Note:  POPDIR is of absolutely no use without first doing a
  196. PUSHDIR.
  197.  
  198. ===============================================================================
  199.  
  200. MTCONV.EXE
  201. __________
  202.  
  203. USAGE:     MTCONV input.fil <optional output.fil>
  204.  
  205. Takes an outline written on Maxthink and converts it into the Structured file 
  206. format, which can be read into PC-Outline, using the File Input Structured 
  207. command from the menu.  This enables information to be transferred easity from 
  208. Maxthink to PC-Outline.
  209. 
  210.